Enums

title: "枚举（Enums）"

description: "使用枚举从预定义选项集中选择，以控制状态、模式和变体"

---

枚举（Enum）让你从一组预定义的选项中选择一个值。

当属性只应是少数几个已知值之一时（如模式、状态或变体），使用枚举，而不是允许像字符串那样的任意值。

例如，不再使用 "left"、"center" 或 "right" 这样的字符串，枚举保证值始终是这些有效选项之一。

枚举可以分为：

• 系统枚举（System Enums）— 编辑器使用的内置选项集（例如水平对齐 Horizontal Align）
• 自定义枚举（Custom Enums） — 你为特定用例定义的选项集

为什么不使用字符串或数字？

想象一个日历应用，根据星期几显示不同的背景。

你可以使用像 "Monday" 这样的字符串，但如果有人将其设置为 "Mon"，它就会失效。

你可以使用数字，但不清楚一周从周日还是周一开始——也不清楚索引是从 0 还是 1 开始。

使用枚举，值必须是已定义的选项之一，因此始终有效且无歧义。

添加枚举属性

1. 创建新的枚举属性
   

   在视图模型内创建一个新的枚举视图模型属性。

2. 设置枚举类型
   

   点击属性名称旁的下拉菜单并选择枚举类型。

3. 设置默认枚举值
   

   选中你的枚举视图模型属性，在右侧边栏中选择默认值。

绑定枚举

枚举可以绑定到使用相同选项集的编辑器属性。例如，名为 "Layout Direction" 的枚举可以绑定到布局的 Direction 属性。

绑定枚举时，需要 System Enum to Uint 转换器，系统会自动应用。

自定义枚举（Custom Enums）

1. 创建新枚举
   

   打开数据面板，点击 + 图标并选择 enum。

2. 添加枚举选项
   

   选中枚举后，在右侧边栏中点击 + 图标。

3. 将枚举分配给属性
   

   将你的自定义枚举分配给枚举视图模型属性。

用枚举控制 Solo

使用枚举通过将每个枚举值映射到一个 Solo 来控制哪个 Solo 处于活动状态。

1. 创建匹配的枚举
   创建一个自定义枚举，其值与 Solo 的名称和顺序相匹配。
2. 绑定枚举
   将枚举绑定到 Solo 的 Active 属性并应用 Convert to Number 转换器。